Summary

Fixes #335

When using UI component libraries like Element UI, Ant Design, or Vuetify, native checkbox <input> elements are typically hidden (display: none, opacity: 0, or visibility: hidden) while a styled wrapper/label is shown instead. The check and uncheck commands directly operate on the native checkbox via Playwright's locator.check() / locator.uncheck(), which waits for the element to become visible — causing an indefinite hang.

Changes

• Added a safeCheckAction() helper that first attempts check()/uncheck() with a 5-second timeout
• If the action fails due to the element being hidden/not visible/timing out, it retries with { force: true } to bypass the visibility check
• Non-visibility errors (e.g., strict mode violations) are re-thrown as before
• Updated all 6 call sites across handleCheck, handleUncheck, handleGetByRole, handleGetByLabel, handleFilter, and handleNth
• Added 9 unit tests covering visible elements, hidden elements (various error messages), and error propagation

How It Works

try check/uncheck with timeout: 5000ms
catch →
  if error is about visibility/hidden/timeout → retry with force: true
  else → rethrow

This ensures:

1. Normal checkboxes work exactly as before (no behavior change)
2. Hidden checkboxes (UI framework pattern) complete successfully via force: true
3. Other errors propagate unchanged